TPUG - Toronto PET Users Group/TPUG Users Group CD/TPUG Users Group CD.iso/MSDOS/(m)aap/DROEGE2.ARC/TUTOR.DOC

Text File | 1986-10-14 | 17KB | 541 lines

                                 Page 3-1


TUTOR.DOC

        This leads you step by step through the use of a few of the most
important system features.  First be sure you have backed up the distribution
disks, see previous section.  Experts will want to start with a clean disk with
only the essential files, see the comment in DEMO.DOC.  These are:

        DROEGE.EXE
        BRUN20.EXE
        SETUP.PCD
        SETUP.PCS
        ALPHAD.LIB  If you want to use letters and numbers
        TUTOR.PCD
        TUTOR.PCS

        As before, we will indicate actions you are to take by three asterisks
followed by text with Enter to indicate typing text followed by the Enter
(carriage return key), or Fn to indicate hitting function key n.

*** DROEGE (Enter)

        The disk should spin and after a while a copyright notice and the
registered owners name address and the serial number should appear.  After you
hit any key, the screen clears and you should now have a pretty blue screen.
You must at least have a color monitor adapter card, even if you don't have a
color monitor.  While it is possible to do some things without color - i.e.
mechanical drawing - the program does not achieve its purpose without color.
The top of the screen should read:

1 MAIN     M  25      %L99   X=  +0.575   Y= +0.575

With a blinking square near the center of the screen.

The bottom of the screen should read:

1ENTER 2FILE  3PLOT  4SETUP 5SYMLST

        The top line of the screen displays the level of the Key Tree - we are
at the entry level (1) which is called the MAIN program level.  Next is
displayed the status of the cursor movement control.  The arrow keys at the
right of the keyboard are used to move the cursor around the screen.  Each time
the arrow keys are pressed they move the cursor the number of steps indicated
by the number after the M.  We think of these as thousandths,  but there is
nothing inherent in this assignment.  If you want to think of them as feet then
you have a 12 by 12 mile work area.  Function key 6 cycles the cursor speed
through seven step sizes starting with the grid setting.  We have set up for a
.025 inch grid so F6 provides speed steps of 25,50,100,125,250,500, and 1000
thousandths.  KP5 provides a speed shift key to speed up movement by a factor
of ten.  We operate with the grid set at 25 thousandths, the speed step set to
the grid we are presently locating things on, usually 100 mills,our left hand
on the function keys and our right hand on the numeric key pad.  We move around
with the arrow keys, shifting to high speed when we need to move a large
distance.

        The next top line entry shows the available storage space as the
percentage left.  The program continuously searches through memory looking for
free space.  This number is updated every 10 minutes or so.  Don't worry, you
                                 Page 3-2
will have difficulty using up significant amounts of memory space between
updates though you should consider ending the job and ordering the full sized
version when down to a few percent.  The next numbers are the X and Y cursor
locations as they relate to the whole work space, which covers +- 32 inches in
X and Y.  It is possible for the cursor to be off the screen, so some times you
may have to move it some way to get it to move.  The cursor indicator always
hangs up at the edge of the screen in the direction it has gone.  The X,Y
indicators tell where it really is.  Data is entered at the real cursor
position.  It is possible to locate data off the screen.

        The bottom line of the screen gives us the current set of choices.
Here we can chose F1 to enter data, F2 to do something with files, F3 to plot
the output, and F4 to manipulate the screen display and F5 to list the symbols.
Since we at present have a blank screen we will use F2 to go to the file system
to get some stuff to work with.

*** F2

        We get a new menu at the bottom of the screen.  Our choices are:

1PUTFIL 2GETFIL 3LIBFIL 4JOBFIL 5LSTSET

        Since we want to get a demo program we:

*** F2

        And we get the menu:

1LODJOB 2LODLIB 3LSTSYM 4LSTLAB 5LSTKEY

        We select 1LODJOB to load a job:

*** F1

        A message appears with a beep asking the name of the job to load, or to
enter "c" to avoid loading a job if we do not want to destroy the present one.
We want the TUTOR job so we enter:

*** TUTOR (ENTER)

        The disk spins, after a short wait, a small circuit layout should
appear on the screen.  If you mistype you can correct in the usual way prior to
enter.  If you enter something not on the disk you will get a "DISK ERROR"
message.  In this case press F1 and try again.

        Please note that very few actions in this program are dangerous - i.e.
cause loss of a lot of work.  It is hard to delete a lot of data quickly.  One
way is by 1SAVJOB or 2SAVLIB with a name that exists on disk when that item has
not been loaded since the nothing stored in the computer will overwrite the
good job on the disk.  To help prevent this problem you are prompted if DROEGE
does not remember you loading the same job you are saving.  Moral: Always Keep
Disk Backups.  Otherwise feel free to push function keys and to explore.  Very
little can go wrong.  On the other hand, it will go wrong so back up your work
periodically with the 1SAVJOB.

        The %L at the top of the screen now reads 91 to indicate that some
space has been occupied by the demonstration program which also brings in a
small library of electronic symbols.

                                 Page 3-3
        You should be able to see a square cursor near the center by the round
pad.  Try moving the cursor around by pressing the arrow keys.  Change its
speed by:

*** F6

        -- Several times -- watch M at the top of the screen.  Note that the
cursor now moves in bigger jumps.  Push until M is back to 25 as this will
match up with the parts locations.

        The circuit displayed does nothing.  It represents an IC, and several
passive components.  As you move the cursor around you will note that you can
measure distances between components by watching the position display.

*** F9
*** F9

        The menu should now change back to the first menu and the top line
should read 1 MAIN.  F9 is an important key.  It backs up the menu and halts
most long operations.  Pushing F9 again will try to back you out of the program
but you are protected by a message.  Anything but a "y" (ENTER) will keep you
from the exit and possible work loss.  Thus you can generally hit F9 freely
waking up when you hear the message beep.  Try hitting F9 one more time.  But
remember what your mother says and don't say yes unless you want to lose your
v--alued data.

*** F1

        Selecting 1ENTER moves us toward entering data, but first we have to
make a few decisions.  Our first choice is between:

1LINE  2PAD   3SYMBOL 4LABEL 5OTHER

*** F1

        We choose lines.  And we get another choice:

1LOCLIN 2LOCPT  3STYLE 4SETUP  5STITCH

        Here we get to choose between editing whole lines or points within
lines.  We also get to set the line style - i.e. solid, dashed etc.. SETUP
appears on many menus and is used to choose screen parameters like which of 12
levels is to be edited, the color with which data on a level will displayed,
the width of entered lines, the grid spacing, and what part of the whole
working area is shown.  We  will choose to locate lines:

*** F1

        We are now four layers deep in the key tree and something new shows up
on the top line.  It now reads:  4>N EDLIN  The right arrow indicates that the
enter key F7 is now operational and that pressing it will cause data to be
added to the data base.  The N following the right arrow indicates that we are
in the normal (not the symbol) mode.  We have preset the screen parameters to
draw red 30 mil wide lines on level 2 and to show them drawn at full width.
The top of the screen reminds us of this by displaying "ENTER LINE ,L2-A RD30.
Lets try to enter a line.  Using the arrow keys move the cursor to the right
end of the left most resistor at the bottom of the screen.

*** F7
                                 Page 3-4

        A faint tick is heard, you have started a line.  Now move the cursor to
the left end of the right resistor at the screen bottom.

*** F8

        A lower pitch tick is heard.  A red 30 mil line appears between the two
circuit pads.  Our convention here is that green lines are on the board top
(level 1) or parts side and that red lines are on the board bottom (level 2) or
solder side.  We always view boards from the parts side.  I looked at boards
from the bottom side for 20 years and switched when we got our first CAD
machine to satisfy my colleagues even though I was the boss.  The most
important thing is to have a standard.  The color is not important, everyone
will have their own preference, the board view is.  There are more ways to make
boards wrong than right and consistency will help keep your board vendor from
doing something awful.

        Move the cursor to the right most of the two free pads at the bottom of
the screen.  By successive F7 make a line without crossing any red line to the
top pad at the top right resistor.  This pad also has a green line ending
there.  Note that you need press F7 only when direction is changed not
every time the cursor is moved.  End the line with an F8.  Note that the last
move should end with an F8.   An F7 and an F8 at the same point is OK but uses
an extra storage space.

*** F7
  "
  "
  "
*** F8

        Our cursor is now sitting on the top of the top right resistor where
two wires end.  Lets find the wire we just entered.

*** F1

        After a few seconds the old green wire is redrawn dashed.  We found the
wrong one.  We reject it:

*** F5

        We reject the green wire.  The red wire is now found and the cursor
moves to its starting point.  A line found message appears telling us that the
current cursor position shown at the top right is the line start.  We could hit
F2 and the line would disappear - try it later.  Instead:

*** F5

        It finds the same line again the way I drew it.  The search algorithm
locates objects by their ends or any intermediate point.  We reject again.  The
cursor continues diligently in a square search with steps equal to the grid
size.  This time we found the green line again.  Note that if something is placed off the current grid it will never be
found.  Note also that we search only for the current thing - i.e. lines when
in line mode, symbols in symbol mode etc..  When you tire of searching and
rejecting:

*** F9

        The search stops when the cursor gets to the upper left hand corner of
                                 Page 3-5
its search pattern and the menu backs up one.  If we had waited a while another
line would have been found.  Again F9 would end the operation and back us up.
F9 will stop most long operations.

*** F1

        Lets go back to the line entry menu and enter a different width line in
a different color.  From the menu 1FIND 2DELETE 3*MODFY 4SETUP  5REJECT we will
pick 4SETUP:

*** F4          1EDSET 2EDLEVL 3EDCOLR 4EDAPER  5SCREN

        Setup 9, shown at the top of the screen tell us what we are now
entering.  Except that since there are 12 levels it can only show us one
without filling the screen.  It now reads:

        SETUP  9,LEVEL  1,COLOR OFF,APER OFF

        We want to change the setup so we select 1EDSET:

*** F1

        We get key 1 and 2 labeled "UP" and "DOWN" and key 5 labeled 5*SETUP to
remind us that we will change the setup.  We push key 1 to go up one setup:

*** F1

        We get an new line at the top of the screen:

        SETUP  10,LEVEL  1,COLOR GREEN,APER RD50

        This is a new color and a new width which should look different so lets
go back to the circuit and enter a new line:

*** F9
*** F9

        And we are back to the  1FIND   2DELETE 3*MODFY 4SETUP  5REJECT menu
which lets us enter lines.  Move the cursor to the top left pad of the IC and
start a power bus.  Run it up so that it clears the other objects the off to
the right edge of the screen.

*** F7
*** F7
*** F8

        Now lets try some fun with symbols.  First we will redraw the screen to
a larger scale.

*** F10
*** F2
*** F3

        This sequence redraws the screen with a preset view we have named the
"big picture" so we could remember it.  You can set up display areas like this
yourself.  See the 10REDRAW command.

*** F9
*** F9
                                 Page 3-6

        This should get us back to the  1LINE   2PAD    3SYMBOL 4LABEL  5OTHER
menu.

*** F3

        We choose symbols.  To enter a symbol we have to give DROEGE a name.
To do so we hit F2:

*** F2

        We get a beep and a prompt - "enter symbol name"

*** BUS (ENTER)

        If you typed correctly in upper case the entry should be accepted
quietly.  Otherwise you might get an error message "symbol not found".  In this
case, hit F2 and try again.  We are now ready to go to locate the symbol bus.
To do this we hit 1LOCSYM:

*** F1

        We get a familiar menu.  In fact all the data entry menus are the same
menu and we can do the same types of things with the same keystrokes.  We have
tried to maintain consistency.  Move the cursor to X=1.900, Y=1.600 and hit
locate.

*** F7

        A bus pattern just like the other two is drawn.  Not only is the chip a
symbol but the chip with the bus wires on it is also a symbol.  Further to
speed drawing the bus, we made the bus wires symbols.  There are two wire
symbols, one for the wires on the left pads and one for the wires on the right
pads.  But we see we have made a mistake.  We connected everything to a bus.
We probably want some power to the circuit.  So let us go and change the
symbol.

*** F9

        We now have the menu    1LOCSYM 2NAME   3CREATE 4SETUP  5ROT=.  Since
we want to be creative we select 3CREATE:

*** F3

        This gives us a menu where we can make a new symbol, kill an old one,
or modify an existing symbol.  We choose to modify the symbol BUS by:

*** F5
*** BUS (RETURN)  Remember symbol names distinguish case.

        The screen clears and the symbol BUS draws to fill the screen.  The
screen is oriented so that 0,0 is at the reference point of the symbol and the
cursor is placed at 0,0.  We want to add a ground bus to pin 7.  If we make it
on the green (level 1) side of the board it will interfere with the bus on pin
8.  Therefore we choose to make it in red on side 2.  We will also remove the
existing bus wire.  Remember I said I made it a symbol so we will look for the
symbol on pin 7.

*** F3   We want symbol mode.
                                 Page 3-7
*** F1   We want the menu with find.  Note the KEYTREE chart is useful when you
         can't remember how to get to some menu.
*** F1   To find a symbol.

        We get the message "SYMBOL LEFT FOUND @ ABOVE X,Y".  This is the
symbol we want so we delete it:

*** F2

        The symbol, which consists of a single bus line, is drawn in
background.  Note that this erased some of the remaining symbol.  You can get a
clean redraw by hitting F10 twice.

*** F10
*** F10

        The symbol is cleanly redrawn.  Now we will enter our bus wire.

*** F9
*** F9
*** F1
*** F1

        And we are back to our line entry menu.  The second screen line tells
us we will enter a line on level one.  We want a red line on level 2 so we go
to the setup menu.  I have a setup listing generated by hitting 4LSTSET from
the file menu.  See KEYTREE.DOC to find it.  So I can look at the listing and
see that I want setup 11.  I could also modify any of the setups to draw the
line I want.  Since I have a setup available:

*** F4
*** F1
*** F1
*** F9
*** F9

        And we now have setup 11.

*** F7          Starting a line at 0,0
*** F7          Moving to 0,-.2 locate a line mid point.
*** F8          Moving to 0.6,-.2 locate a line end.

        We have now modified our symbol so it has a power bus.  Now lets go
back and see what this did to the job.

*** F9
*** F9
*** F9

        We have finished our changes so we answer "y" to the exit symbol
question.

*** Y (ENTER)

        We get a symbol closed message and a beep.  We can now elect to redraw.
The old symbol stays until we redraw.

*** F10
*** F10
                                 Page 3-8

        The screen redraws the lower left corner of the job.  Unless we tell it
to, two redraws cause a redraw of the present screen window position.  We
really want the "big picture" so:

*** F10
*** F3          It happens to be sitting on the item we want so no up or down
                is needed.

        The screen redraws and we see the three circuits nicely connected with
a bus.
















































                                 Page 3-9